What is @lingui/core?
@lingui/core is a library for internationalization (i18n) in JavaScript applications. It provides tools for managing translations, formatting messages, and handling locale data. It is designed to be flexible and easy to integrate with various frameworks and libraries.
What are @lingui/core's main functionalities?
Message Formatting
This feature allows you to format messages with placeholders that can be replaced with dynamic values. The example demonstrates loading a translation, activating a locale, and formatting a message with a dynamic name.
const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');
const i18n = setupI18n();
i18n.load({
en: {
message: 'Hello, {name}!'
}
});
i18n.activate('en');
const message = i18n._('message', { name: 'John' });
console.log(message); // Output: Hello, John!
Locale Management
This feature allows you to manage different locales and switch between them. The example shows how to load translations for multiple locales and activate a specific locale to get the translated message.
const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');
const i18n = setupI18n();
i18n.load({
en: { message: 'Hello' },
fr: { message: 'Bonjour' }
});
i18n.activate('fr');
const message = i18n._('message');
console.log(message); // Output: Bonjour
Custom Pluralization Rules
This feature allows you to define custom pluralization rules for different languages. The example demonstrates how to use pluralization in a message based on the count value.
const { i18n } = require('@lingui/core');
const { setupI18n } = require('@lingui/core');
const i18n = setupI18n();
i18n.load({
en: {
message: '{count, plural, one {# item} other {# items}}'
}
});
i18n.activate('en');
const message = i18n._('message', { count: 5 });
console.log(message); // Output: 5 items
Other packages similar to @lingui/core
i18next
i18next is a popular internationalization framework for JavaScript. It provides similar functionalities to @lingui/core, such as message formatting, locale management, and pluralization. However, i18next has a larger ecosystem with more plugins and integrations available.
react-intl
react-intl is a library specifically designed for internationalization in React applications. It offers similar features to @lingui/core, such as message formatting and locale management, but is tightly integrated with React components and hooks.
globalize
Globalize is a library for internationalization and localization in JavaScript. It provides functionalities for formatting numbers, dates, and messages, similar to @lingui/core. Globalize is built on top of the Unicode CLDR data and focuses on providing comprehensive localization support.
![Downloads](https://img.shields.io/npm/dw/@lingui/core.svg)
@lingui/core
Internationalization API for JavaScript apps
@lingui/core
is part of LinguiJS. See the documentation for all information, tutorials and examples.
Installation
npm install --save @lingui/core
Usage
See the tutorial or reference documentation.
License
This package is licensed under MIT license.